约 1946 字
约 10 分钟
#HTML 的
<textarea> HTML 元素是一个多行纯文本编辑控件，适用于允许用户输入大量自由格式文本的场景，例如评论或反馈表单。 > !class:info > 请查看 [HTML 元素帮助手册](/document/zh/03.HTML/99.帮助手册/01.HTML%20元素帮助手册.md) 了解更多 HTML 元素。 ## 属性 > !class:info > 请查看 [HTML 元素的全局属性](/document/zh/03.HTML/99.帮助手册/02.HTML%20元素的全局属性.md) 了解 HTML 元素的全局属性。 * `autocapitalize`: 控制输入文本是否自动大写。有关更多信息，请参阅 autocapitalize 全局属性页面。 * `autocomplete`: 此属性指示浏览器是否可以自动完成控件的值。可能的值包括： * `off` ：每次使用时，用户都必须明确为此字段输入值，或者文档提供自己的自动完成方法；浏览器不会自动完成条目。 * `on` ：浏览器可以根据用户在以前使用过程中输入的值自动完成该值。 * `autocorrect`: 一个字符串，指示在用户编辑此 textarea 时是否激活自动拼写纠正和文本替换（如果有配置）。允许的值包括： * `on`: 启用自动拼写纠正和文本替换。 * `off`: 禁用自动拼写纠正和文本替换。 * `autofocus`: 此布尔属性可让你指定当页面加载时，表单控件应获取输入焦点。文档中只有一个与表单相关的元素可以指定此属性。 * `cols`: 文本控件的可见宽度，以平均字符宽度为单位。若已指定，其值必须为正整数。若未指定，默认值为 20。 * `dirname`: 此属性用于指示元素内容的文本方向性，类似于 <input> 元素的 dirname 属性。有关更多信息，请参见 dirname 属性。 * `disabled`: 此布尔属性表示用户无法与控件交互。如果未指定此属性，控件将从其包含元素（如 <fieldset>）继承设置；如果在设置 disabled 属性时没有包含元素，则控件处于启用状态。 * `form`: 与 <textarea> 元素相关联的表单元素（其“表单所有者”）。此属性的值必须是同一文档中某个表单元素的 id。如果未指定此属性，<textarea> 元素必须是表单元素的后代。此属性允许你将 <textarea> 元素放置在文档内的任何位置，而不仅仅是作为表单元素的后代。 * `maxlength`: 要求用户输入的最大字符串长度（以 UTF-16 码元衡量）。如果未指定此值，用户可以输入无限数量的字符。 * `minlength`: 要求用户输入的最小字符串长度（以 UTF-16 码元衡量）。 * `name`: 控件的名称。 * `placeholder`: 对用户关于可在该控件中输入内容的提示。在占位符文本内部的回车或换行符在渲染提示时必须被视为换行处理。 * `readonly`: 此布尔属性表示用户无法修改该控件的值。与 disabled 属性不同，readonly 属性不会阻止用户点击或选择该控件。只读控件的值仍随表单一起提交。 * `required`: 此属性规定用户在提交表单前必须填写一个值。 * `rows`: 显示控件的指定的可见文本行数，其值必须为正整数。若未指定，默认值为 2。 * `spellcheck`: 指定是否应由底层浏览器/操作系统对 <textarea> 进行拼写检查。可能的值包括： * `true` ：指示应对此元素进行拼写和语法检查。 * `default` ：指示元素应遵循默认行为，该行为可能基于其父元素自身的 spellcheck 值。 * `false` ：指示不应对此元素进行拼写检查。 * `wrap`: 指示控件应如何对表单提交时的值进行换行。可能的值包括： * `hard` ：浏览器会自动插入换行符（CR+LF），以确保每一行不超过控件宽度；要使此效果生效，必须指定 cols 属性。 * `soft` ：浏览器确保输入值中的所有换行均为 CR+LF 一对，但不会为此值添加额外的换行。 * `off` 非标准 ：类似于 soft，但外观表现为 white-space: pre，即超出 cols 宽度的不会换行，此时 <textarea> 将变为水平可滚动。创建于 2025/5/22
更新于 2025/5/27